home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / gfactory.zip / GFDOC.TXT < prev    next >
Text File  |  1992-09-21  |  34KB  |  659 lines
  1. The Graphics Factory
  2. Copyright (C) 1992 James A. Sausville
  3. All Rights Reserved
  4.  
  5. I. INTRODUCTION
  6. ---------------
  7.  
  8. The Graphics Factory is a utility that allows you to create sets
  9. of graphics for use in your own basic programs. While intended for
  10. use with Quick Basic V4.5 , the graphics created by this program
  11. can be used by any version of basic that supports Microsoft
  12. compatible BLOAD and PUT graphics commands. To start the Graphics
  13. Factory, type GFACTORY at the DOS prompt.
  14.  
  15.  
  16. HARDWARE REQUIREMENTS
  17.  
  18. The recommended minimum hardware configuration for the graphics
  19. factory is an IBM compatible with a 286 microprocessor and 640k
  20. of RAM. The program will run on XT compatibles, albeit rather
  21. slowly. The amount of free RAM required is approximately 571,648
  22. bytes. Please note that free RAM is the amount of memory available
  23. to a program after DOS, device drivers and TSR programs are loaded.
  24. You can check the amount of free RAM you have available by running
  25. the DOS check disk program. Type "CHKDSK" at the DOS prompt when
  26. you have your DOS disk in drive A:, or when you are logged into the
  27. DOS directory on your hard disk, to run this DOS program.
  28.  
  29.  
  30. SCREEN DESCRIPTION
  31.  
  32. The large rectangle in the upper left corner of the screen is the
  33. editing window. All drawing and editing of the current image is
  34. performed in this window. The image in the editing window is a 6X
  35. magnification of the current image.
  36.  
  37. The small rectangle in the center of the screen is the active frame.
  38. The current image is displayed normal size in the active frame. All
  39. changes made in the editing window are immediatly shown in the
  40. active frame.
  41.  
  42. There are 48 storage frames located at the bottom of the screen.
  43. Graphic images you create can be stored in these frames. There are
  44. six pages of storage frames, only one of which is displayed on
  45. screen at a time.
  46.  
  47. The line of text at the top left of the screen is the mode and
  48. message line. It displays the current drawing mode (dot,line,etc.)
  49. or the current active funtion (circle,box,etc.), along with
  50. instructions on what input may be required. Any text that appears
  51. in a window at the center of the screen supercedes any text that
  52. is on the mode line.
  53.  
  54. Immediately below the mode line is the main menu. There are two
  55. columns of commands, each command preceded by a letter in brackets.
  56. Pressing the letter key indicated in brackets will activate the
  57. command (or function). Pressing the escape key [Esc] will cancel
  58. (abort) a function in progress and return you to the main menu.
  59. Mouse users may simply move the mouse cusor over the desired command
  60. and press the left mouse button to activate it.
  61.  
  62. Below the menu is a status line that informs you of the current
  63. frame size and which page of graphics is currently diplayed (Active
  64. Page). Below the status line and above the active frame the current
  65. X and Y locations of the drawing cursor are displayed. This display
  66. allows more accurate placement of circles and other graphics.
  67.  
  68. Below the status line and to the right of the active frame is the
  69. color palette. An arrow above the colors indicates the current
  70. drawing color. Keyboard users should press the [<] and [>] keys
  71. to change the drawing color. Mouse users should move the mouse cursor
  72. over the desired color and press the left mouse button to select it.
  73.  
  74.  
  75. II. SUMMARY OF COMMANDS
  76. -----------------------
  77.  
  78. The commands are presented in the order they appear on the screen.
  79. Where necessary, separate instructions are provided for keyboard and
  80. Mouse users.
  81.  
  82. [A] Animate Frames - This function allows you to define a series
  83. of frames as an animation sequence. The program displays the maximum
  84. number of frames you may include in the sequence on the mode line
  85. and prompts you to select the first frame. Keyboard users should
  86. use the cusor keys to move the flashing frame border to indicate
  87. the first frame, pressing [Enter] to select the frame. You may select
  88. a frame on a different storage page by pressing the [Tab] key to
  89. cycle through the storage pages.
  90.  
  91. Mouse users should move the mouse cursor over the desired frame and
  92. press the left mouse button to select it. The storage pages may be
  93. cycled through by moving the mouse cursor over the "[Tab] Next Page"
  94. portion of the menu and pressing the left mouse button.
  95.  
  96. The frame selected should appear in the active frame. The program
  97. will then prompt you for the next frame in the animation sequence.
  98. The same frame may be used as many times as desired in the sequence.
  99. Press [Esc] when you have finished selecting frames for the animation
  100. sequence. Mouse users may move the mouse cusor outside of the storage
  101. frames and press the left mouse button to end the selection.
  102.  
  103. The animation sequence will now be displayed in the active frame.
  104. Press the [<] key to decrease the display rate and the [>] key to
  105. increase the display rate. Mouse users should move the mouse cursor
  106. over the "[<]" and "[>]" symbols above the color palette and press
  107. the left mouse button to change the display rate. Pressing the left
  108. mouse button when the cursor is anywhere else will end the display,
  109. as will pressing the [Esc] key.
  110.  
  111. Next the program will ask if you want to save the animation sequence
  112. as a frame set. This allows the use of simple (but memory inefficient)
  113. animation, instead of the type shown in the example program
  114. "JACKDEMO.BAS". If you choose to save the sequence you will be
  115. prompted to enter the path (drive & directory) and file name you
  116. desire.
  117.  
  118. [B] Frame Boundaries - Allows you to change the maximum width and
  119. height of your graphics. Any graphic in the active frame will be
  120. cropped (if necessary) to fit the new dimensions. A new right and
  121. bottom margin are set up inside of the editing window. No drawing
  122. or editing can take place outside these boundaries. You should
  123. normally set the size of your frames before you start drawing. When
  124. you load two sets of frames of different size the boundaries should
  125. be set to accomodate the larger frames.
  126.  
  127. [C] Clear Active Page - Erases all of the graphics in the storage
  128. page currently displayed at the bottom of the screen.
  129.  
  130. [D] Duplicate Frame - Will make an exact copy of one storage frame
  131. appear in another storage frame. Very useful for "experimenting" on
  132. a graphic without destroying the original. Simply select the frame
  133. to duplicate, and then select the frame to copy it to. Mouse users
  134. should select a frame by moving the mouse cursor over the desired
  135. frame and pressing the left mouse button. Keyboard users should
  136. use the cusor keys to move the flashing frame border to indicate
  137. the desired frame, pressing [Enter] to select it.
  138.  
  139. [E] Erase Frame - Will erase the contents of the active frame.
  140.  
  141. [F] Fill Area - Works just like the Quick Basic PAINT command. You
  142. are prompted to select a color to fill with. Mouse users should
  143. move the mouse cursor over the desired color and press the left
  144. mouse button. Keyboard users should press the [<] and [>] keys to
  145. move the indicator arrow to the desired color and press [Enter].
  146.  
  147. Next you are asked to select the color the fill will terminate at.
  148. If, for example, you wanted to fill a red circle, red should be
  149. chosen as the color the fill should stop at. Choose this color in
  150. the same manner as you did before.
  151.  
  152. Finally you will be asked to indicate where the fill will start.
  153. Move the mouse cursor to the desired area of the editing window
  154. and press the left mouse button, or use the cursor keys to move
  155. the editing cursor to the desired area and press [Enter].
  156.  
  157. [G] Get Frame - Allows you to retrieve an image from the storage
  158. frames at the bottom of the screen and place it in the active frame.
  159. After pressing [G] to activate the command, keyboard users should
  160. use the cursor keys to move the flashing frame border to the desired
  161. frame, pressing [Enter] to select it.
  162.  
  163. Mouse users can retrieve a frame by moving the mouse cursor over
  164. the storage frames and pressing the left mouse button, then by moving
  165. the mouse cursor to the specific frame and pressing the left mouse
  166. button again. (There is no need to press the [G] key or to "click"
  167. on the main